Copyright: ShellWizard Help © 1996 Per Mellstrand. All rights reserved.
Citation: ShellWizard Help © 1996 Per Mellstrand. All rights reserved.


What is ShellWizard (95) And What Does It Do?

ShellWizard is a program which lets you configure more settings in Windows 95.

It will, for instance, let you get rid of the "Shortcut to" prefix on shortcuts.

ShellWizard also includes a macro language, with which you easily can

create your own plugins or use others.


About ShellWizard / License Agreement

ShellWizard © 1996 Per Mellstrand. All rights reserved.

License agreement

This program is provided "as is". There is no guarantee that it will work.

You use this program at your own risk. The author does not take any responsibility for damage caused by this program. When you use this program you are responsible for any damage it might cause.

ShellWizard is shareware. This means that you are allowed to evaluate this program for 20 days. If you keep the program for more than 20 days, you must pay for it. If you don't pay for it, you are using this program illegally.

The author is a Swedish citizen and is not affected by any laws other than international and Swedish ones.

The serial number you receive when you register is not guaranteed to work with any other version than the one you registered (though it might work with later versions).

ShellWizard must not be distributed in any other form than the full archive. You must not alter or disassemble any of the files present in the archive. If you do, you will be prosecuted. Distribution of ShellWizard serial numbers is strictly prohibited. If this happens, the person who did it will be prosecuted.

By using ShellWizard you accept this agreement.


ShellWizard Reference: Desktop Tab

My computer

Name	The name of  the desktop icon "My computer".

Recycle bin

Name	The name of the desktop icon "Recycle bin"

Net hood

Name	The name of the desktop icon "Network Neighborhood"
Show Net hood icon on the desktop	If this checkbox is checked the Network Neighborhood icon will be visible on the desktop.


ShellWizard Reference:  General Windows 95 UI Settings tab

Drag full windows

Drag full windows	Determines if windows display the full window or just a frame of the window when you move them.

Menu Show Delay

Time to wait	The delay before submenus appear inside other menus.

Window Animation

Use Window animation	Determines if windows will make a nice effect when you minimize and restore a window.


ShellWizard Reference:  Windows Registration Data

Windows Registration Data

Name	The name that you entered in the Windows 95 setup.

Version

These settings are actually to no use.

Version	Always Windows 95 (?)
Version Number	Windows Version number.


ShellWizard Reference:  Special Tab

Explorer

Warp long filenames	Determines if Explorer will warp long filenames.

Document Templates

If you drag a document to this tab, it will be used as a document template. Document templates appear on the new menu. (Right-click in Explorer choose new).

Items

Create as file	Creates the item as a file. (All items don’t work properly)
Add to Start Menu	Creates the item as a file in the start menu. (All items don’t work properly)

Plugins

You can extend ShellWizard's capabilities with a plugin. You can easily write plugins in a normal text editor. Please see the ShellWizard language reference for more help on plugins. New plugins may be found on the ShellWizard homepage (http://www.exmandato.se/~per/shellwizard/). The button "Plugins..." shows a list of all plugins in the windows directory.


ShellWizard Reference:  Boot Tab

General

Function keys available	Determines whether you can interrupt the boot process by pressing for example F8.
... for x seconds	The time windows will wait to see if you have pressed any function keys.
Show splash screen while loading	If Windows will display the splash screen while starting.
Start GUI automatically	If Windows will start the Graphical User Interface automatically. (Instead of DOS)

Boot Menu

Always show Boot Menu	Determines if Windows always displays a boot menu at start up.
Choose default item after x seconds.	If you don't press any key when the boot menu appears, windows will chose the default item after x  seconds.


ShellWizard Reference:  MRUs Tab

Note: If any of the checkboxes on this page is checked, ShellWizard will automatically be launched every time you start Windows.

Documents Menu

Clear documents menu when ...	If this option is checked the documents menu will automatically be cleared every time you start Windows.


ShellWizard Reference:  Remove Programs Tab

Use this tab to remove unwanted entries from the "Add/Remove Programs"  control panel.


Macro Language Introduction

You can create extensions to ShellWizard, so-called plugins. A plugin is a normal text file with the .swe extension. The Macro language is not like C, Basic or any other language. In fact it's a very simple language but still very useful. Please take a look at the example:

File "example1.swe":

[General]

DisplayName=This is a simple example

# Displayname is the name that ShellWizard should display in the list of plugins.

# This entry MUST exist in all plugins

LanguageVersion=1

# LanguageVersion tells ShellWizard which version of the macro language this file is written in

# This entry MUST exist in all plugins. Use version 1 for ShellWizard 1.0

[FileOperations]

NumberOfEntries=1

# This tells ShellWizard how many file operations your plugin will do.

[FileOperation#1]

Operation=3

# Operation 3 = Create new folder. Please see the language reference for details.

Destination=c:\This_is_a_sample_folder

# This tells ShellWizard where to create the folder and what to name it.

# In this case the folder will be created in c:\ an named This_is_a_sample_folder .

End Of File

All lines beginning with the # sign are comments. You can include them in the file if you wish but they have no real function.

If you want to try this example, copy the source to a file called "example1.swe" and be sure to put it into your windows directory. When you see the list of plugins in ShellWizard you should see an item called "This is a simple example". Just select it and press run.

If this doesn't work please check the following:

Is the file in your Windows directory?

Does the file have the .swe extension?

If it still doesn't work please send me an email (per@exmandato.se).

If example1 works and you want to try to change something, you can try the following:

File "example2.swe":

[general]

DisplayName=This is my second test

LanguageVersion=1

[FileOperations]

NumberOfEntries=3

[FileOperation#1]

Operation=3

Destination=c:\MyNewFolder

[FileOperation#2]

Operation=1

# Operation 1 = Copy file

Source=c:\autoexec.bat

Destination=c:\MyNewFolder\autoexec.backup

[FileOperation#3]

Operation=1

Source=c:\config.sys

Destination=c:\MyNewFolder\config.backup

End Of File

This example will create a folder called "MyNewFolder" in c:\ and copy the files c:\autoexec.bat and c:\config.sys to the new folder. The files will be renamed to autoexec.backup and config.backup.

For more examples please see the "examples" section of the ShellWizard help.


ShellWizard Macro Language Reference : Headers needed in all plugins

ShellWizard requires some entries in the plugin file to accept it. All these entries are under the [General] section.

General:DisplayName

This is necessary for ShellWizard so it knows what name to display.

General:LanguageVersion

ShellWizard checks this entry and compares it to the version of the language it can handle. You will get an error if this entry not is present. You will also get an error from ShellWizard 1.00 if this is anything other than 1.

Example:

[General]

DisplayName=This is the name of my plugin

LanguageVersion=1

End of example


ShellWizard Macro Language Reference : Writing to the registry

Registry:NumberOfEntries

This is used to tell ShellWizard how many changes to the registry your plugin will make.

RegistryEntry#?:Type

The type of data you are writing to the registry.

Possible values:

0	Write a string

1	Write an integer

RegistryEntry#?:Base

The base key where the data is to be stored.

Possible values:

0	HKEY_CLASSES_ROOT

1	HKEY_CURRENT_USER

2	HKEY_LOCAL_MACHINE

RegistryEntry#?:Path

The path the subkey where the data will be stored.

RegistryEntry#?:Entry

The entry in the subkey where the data will be stored.

RegistryEntry#?:Data

The data which will be stored.

Example1

[General]

DisplayName=Simple Registry patch 1

LanguageVersion=1

[Registry]

NumberOfEntries=1

[RegistryEntry#1]

Type=0

Base=1

Path=example\example1

Entry=Entry1

Data=Hello World

End Of Example

This example will add the subkey example\example1 to HKEY_URRENT_USER. It will also set the value "entry1" in this subkey  to "Hello world".

Example2

[General]

DisplayName=Simple Registry patch 2

LanguageVersion=1

[Registry]

NumberOfEntries=2

[RegistryEntry#1]

Type=0

Base=1

Path=example\example2

Entry=Text

Data=Hello world!

[RegistryEntry#2]

Type=1

Base=1

Path=example\example2

Entry=Integer

Data=55

End Of Example


ShellWizard Macro Language Reference : Writing to INI-Files

IniFiles:NumberOfEntries

This is used to tell ShellWizard how many changes to INI files your plugin will do.

IniFileEntry#?:File

The path to the ini file.

IniFileEntry#?:Section

The section in the ini file.

IniFileEntry#?:Entry

The entry to be written

IniFileEntry#?:Data

The data to be written.

Example

[General]

DisplayName=Simple INI file patch

LanguageVersion=1

[IniFiles]

NumberOfEntries=1

[IniFileEntry#1]

File=c:\testfile.ini

Section=Test section

Entry=Entry1

Data=Hello Ini file!

End of Example


ShellWizard Macro Language Reference : Writing to WIN.INI

WIN.INI:NumberOfEntries

This is used to tell ShellWizard how many changes to win.ini  your plugin will do.

Win.IniEntry#?:Section

The section in the ini file.

Win.IniEntry#?:Entry

The entry to be written.

Win.IniEntry#?:Data

The data to be written.

Example

[General]

DisplayName=Simple WIN.INI patch

LanguageVersion=1

[Win.INI]

NumberOfEntries=1

[Win.iniEntry#1]

Section=Test section

Entry=Entry1

Data=Hello Win.INI!

End of Example


Plugin programmers, read this!

The current version of ShellWizard macro language is just a test. Is anyone interested in using this language? What features would you like to be added to the language? Please send me a mail (per@exmandato.se)

Plugins wanted

Have you developed a plugin you wish to share with the rest of the ShellWizard users?

Please visit the ShellWizard homepage and submit your plugin! You can find ShellWizard homepage at http://www.exmandato.se/~per/shellwizard/ .


ShellWizard Macro Language Reference : File Functions

FileOperations:NumberOfEntries

This is used to tell ShellWizard how many file operation  your plugin will do.

FileOperation#?Operation

Tells what file operation to do.

Possible values

0	Move file

1	Copy file

2	Delete File

3	Create Directory	Creates a directory at destination.

4	Delete Directory 	Deletes a directory at destination.

 FileOperation#?:Source

The source file.

Win.IniEntry#?:Destination

The destination file.

Example (copy a file)

[General]

DisplayName=This will copy a file

LanguageVersion=1

[FileOperations]

NumberOfEntries=1

[FileOperation#1]

Operation=1

Source=c:\autoexec.bat

Destination=c:\autoexec.backup

End of Example

Example (move a file)

[General]

DisplayName=This will move a file

LanguageVersion=1

[FileOperations]

NumberOfEntries=1

[FileOperation#1]

Operation=0

Source=c:\autoexec.backup

Destination=c:\autoexec.backup2

End of Example

Example (delete a file)

[General]

DisplayName=This will delete a file

LanguageVersion=1

[FileOperations]

NumberOfEntries=1

[FileOperation#1]

Operation=2

Destination=c:\autoexec.backup

End of Example

Example (create a directory)

[General]

DisplayName=This will create a directory

LanguageVersion=1

[FileOperations]

NumberOfEntries=1

[FileOperation#1]

Operation=3

Destination=c:\example folder

End of Example

Example (delete a directory)

[General]

DisplayName=This will delete a directory

LanguageVersion=1

[FileOperations]

NumberOfEntries=1

[FileOperation#1]

Operation=4

Destination=c:\example folder

End of Example


ShellWizard Macro Language Reference : Displaying Messages

You can display messages before and after your plugin is executed. If you display a message before, it will contain a yes and no button.The plugin will only be executed if the user presses the yes button. If you diplay any message after the execution, the dialog will contain a OK button.

Displaying messages before execution

General:DisplayStartMessage

Set this value to 1 if you want to display a start message.

General:StartMessage

The message to display.

Displaying finish messages

General:DisplayFinishMessage

Set this value to 1 if you want to display a finish message.

General:FinishMessage

The message to display.

Example (start message)

[General]

DisplayName=This plugin will only display a dialog

LanguageVersion=1

DisplayStartMessage=1

StartMessage=This is a sample message. Do you wish to continue?

End of Example

Example (finish message)

[General]

DisplayName=This plugin will only display a dialog

LanguageVersion=1

DisplayFinishMessage=1

FinishMessage=This is a sample message.

End of Example


ShellWizard Macro Language Examples : Small backup utility

This plugin will backup the files autoexec.bat , config.sys win.ini & system.ini to a floppy (a:\).

This example will only work if your windows directory is c:\windows .

Example

# Small Backup Utility © 1996 Per Mellstrand.

#This file is a part of the ShellWizard documentation.

[General]

DisplayName=Small Backup utlilty

LanguageVersion=1

DisplayStartMessage=1

StartMessage=This plugin will backup some system files to a: Do you wish to continue?

DisplayFinishMessage=1

FinishMessage=Ok, all files copied.

[FileOperations]

NumberOfEntries=3

[FileOperation#1]

Operation=1

Source=c:\autoexec.bat

Destination=a:\autoexec.bat.backup

[FileOperation#2]

Operation=1

Source=c:\config.sys

Destination=a:\config.sys.backup

[FileOperation#3]

Operation=1

Source=c:\windows\win.ini

Destination=a:\win.ini.backup

[FileOperation#4]

Operation=1

Source=c:\windows\system.ini

Destination=a:\system.ini.backup

End of Example


ShellWizard Macro Language Examples : Clear Excel 7.0 MRU

This example will clear the Excel 7.0 MRU.

Example

# Clear Excel 7.0 MRU © 1996 Per Mellstrand.

#This file is a part of the ShellWizard documentation.

[General]

DisplayName=Clear Excel 7.0 MRU

LanguageVersion=1

DisplayStartMessage=1

StartMessage=This plugin will clear Excel 7.0s MRU. Do you wish to continue?

DisplayFinishMessage=1

FinishMessage=Ok, no more Excel MRU!

[Registry]

NumberOfEntries=4

[RegistryEntry#1]

Type=0

Base=1

Path=Software\Microsoft\Excel\7.0\Recent File List

Entry=File1

Data=

[RegistryEntry#2]

Type=0

Base=1

Path=Software\Microsoft\Excel\7.0\Recent File List

Entry=File2

Data=

[RegistryEntry#3]

Type=0

Base=1

Path=Software\Microsoft\Excel\7.0\Recent File List

Entry=File3

Data=

[RegistryEntry#4]

Type=0

Base=1

Path=Software\Microsoft\Excel\7.0\Recent File List

Entry=File4

Data=

End of Example


Shareware

So, you bought that nice shareware disk for $5-20! And you found ShellWizard! Are you a registered user? Not really. If you paid any money for a shareware disk I haven't received any of it! In fact, you can download ShellWizard for free from the internet but this doesn't mean that ShellWizard is free. ShellWizard is distributed as Shareware. This means that you may try this software for 20 days, then you must either pay the author a small amount of money or delete it from your hard disk. If you decide to keep ShellWizard, you have to pay for it.

Type of registration	Register by Email	Register by Snail Mail
Individual	$10	$15
Company (limited no of users)	$10/User (please see quantity discounts)	$5+$10/User (please see quantity discounts)
Company (unlimited no of users)	$500	$510
Quantity discounts:

2-4	5-10	11-20	21-30	31-50	51-71
20%	30%	35%	40%	50%	55%

When you register, you will receive a serial number to enter inside the program.

You will not receive any disks or other hardware.

The password you receive is guaranteed to work only with the version you are registering, but it ight work with minor upgrades as well.

How to register:

1) Send me a letter containing the following information:

•	Your name

•	Type of registration (individual or company)

•	How many licenses you wish to purchase

•	If you want the registration information sent to you via email or snail mail.

(Please use email if possible.)

•	Your address

•	The money

2) Send me the letter.

Note to Swedish users (Yes... it's in Swedish):

Du kan även registrera ShellWizard genom att betala till mitt postgiro. (790811-2910)

OBS: De kvitton som jag får inehåller inte din email-adress! Skicka därför ett email till mig innan du registrerar dig via postgiro.

My address:

Email:	per@exmandato.se

or:	per@exmandato.com

Snail mail:

Per Mellstrand

Tvarhands gr 14

S-39363 KALMAR

SWEDEN


ShellWizard FAQ

Q:	What is ShellWizard?

A:	Please see What is "ShellWizard and what does it do?whatis"

Q:	What will happen after my 20 days evaluation period? Will ShellWizard stop working?

A:	No, it won't. However, the delay at the startup will be increased.

Q:	Help! I get an error message telling me that I don't have the correct date.

A:	The Unregistered version of ShellWizard checks your date to determine how long you have

used it. If you get this error message you probably have turned your date back.

Q:	Help! I have the registered version, and a friend asked me to give it to him (her)! What to 	do?

A:	Give him (her) your version, but not your serial number. ShellWizard will automatically 	unregister itself on the new computer.

Q:	Where can I download the latest version of ShellWizard?

A:	If you have internet access, you can get it at http://www.exmandato.se/~per/shellwizard/

Q:	Why is your English so bad? Why don't you write a READABLE help file?

A: 	Write a better one yourself. Please send ma a email if you would like to correct this help file. 	( The first person who does will get the registered version)


ShellWizard Reference:  Explorer Settings Tab

Thumbnails

Use thumbnails	If this option is on, Windows will use a thumbnail of .bmp files as their icon.

Shortcuts

Show arrows on shortcut icons	Determines if Windows will use the arrow overlay on shortcut icons.
Prefix "Shortcut to" on new shortcuts	If this checkbox is checked, windows will use the prefix "Shortcut to" on all new shortcuts created.